home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 10 / AACD 10.iso / AACD / Magazine / Online / MagPLIP / Linux / Installation < prev    next >
Text File  |  1997-12-23  |  4KB  |  111 lines
  1.  
  2.   magPLIP - SANA II compliant PLIP device driver for AmiTCP/IP, Envoy,
  3.             AS225 and other networking packages.
  4.  
  5.     revision 38.1
  6.  
  7.  
  8.   This file describes how to install the magPLIP driver on your Linux
  9. System. You should already have installed the linplip.device on your
  10. Amiga. 
  11.  
  12.  You'll need the source for a linux kernel whose version is at least
  13. 2.0.26. 
  14.  
  15.  First step : adding plip.c to your kernel
  16.  -----------------------------------------
  17.  
  18.   Support for magPLIP isn't part of the standard linux kernel and will
  19. likely never be, for such a support is of no use whatsoever without
  20. the linplip.device for Amiga. Thus, you'll have to recompile your
  21. kernel, even if you added PLIP support.
  22.  
  23.   I suppose you already know how to configure and compile your kernel, 
  24. and that you know how to use modules. If not, see the Kernel-HOWTO and
  25. the Module-HOWTO. 
  26.  
  27.   The file present in the distribution (plip.c) is a modified version
  28. of the plip driver distributed in the kernel revision 2.0.26. It may or
  29. may not work with other version of the kernel. Send a mail to 
  30. if you believe that your kernel (2.0.27 or later) is not compatible any 
  31. longer with plip.c. 
  32.  
  33.   What you have to do : 
  34.     
  35.      copy plip.c to /usr/src/linux/drivers/net/plip.c
  36.         (make a copy of your old plip.c if you want to use it
  37.          later. See Using the original PLIP driver at the end
  38.          of this file.) 
  39.  
  40.  Second step : compiling the kernel and setting up your system
  41.  -------------------------------------------------------------
  42.  
  43.   Now, the procedure is exactly the same as the one described
  44.   in the PLIP mini-HOWTO. See this file and follow its instructions. I
  45.   am not going to repeat here these instruction, as I couldn't
  46.   do any better than the author of the HOWTO.  
  47.   
  48.   Remember that you HAVE to recompile your kernel or at least
  49.   the plip driver to use this version of the driver.
  50.  
  51.   If you get error messages while compiling the plip.c file, 
  52.   and that your kernel version is at least 2.0.26, please send
  53.   me a mail containing the exact version of your kernel and
  54.   the error messages you got from gcc. <Stephane.Zermatten@earthling.net>
  55.  
  56.  
  57.  
  58.  Using both the original PLIP driver and the modified magPLIP driver
  59.  -------------------------------------------------------------------
  60.  
  61.   You'll have to compile both the original driver and the modified
  62. version as modules to do this. In order to do that, 
  63.     1. configure your kernel Makefiles for including PLIP support 
  64.            as a module.
  65.     2. leave or replace the original version of plip.c in 
  66.        driver/net/plip.c 
  67.     3. run "make modules" 
  68.     4. copy the module modules/plip.o wherever you want
  69.        (in lib/modules or lib/modules/2.0.26/net or whatever) 
  70.      5. place my version of plip.c in driver/net/plip.c
  71.     6. run "make modules" again
  72.     7. copy the module modules/plip.o under the name magplip.o
  73.        in the same directory as the original plip.o
  74.  
  75.  
  76.   Now, you've got two different modules, plip.o, which contains the
  77. driver to connect to another Linux system, and magplip.o, which contains
  78. the driver you should use to connect to an Amiga. 
  79.  
  80.   If you're not going to connect to both an Amiga and another Linux system
  81. at the same time, you can load the module you want to use when you
  82. want. Note that kerneld won't be able to guess which module you want; you
  83. have to do it manually, typing "insmod plip.o" or "insmod magplip.o", or 
  84. write a script. 
  85.  
  86.   If you have several parallel ports and want to connect to a PC running
  87. Linux and an Amiga at the same time, you can run into a bit of a trouble...
  88. The best way to do it would be to write a version that supports both
  89. protocols. I intend to write it, when I have the time... Tell me if you
  90. need it. 
  91.  
  92.   There is a much cleaner way to do all this, but you'll have to modify the 
  93. Makefile and the configuration script of the kernel, as well as the 
  94. source code. That's too much for me. I'll leave that to kernel hackers.
  95. If you do it, please send me a description of the procedure you've
  96. used, so that I can include it in a future release.  
  97.  
  98.  
  99.  See also 
  100.  --------
  101.  
  102.     the PLIP mini-HOWTO
  103.     Kernel-HOWTO
  104.     Module-HOWTO
  105.     the magPLIP documentation (magPLIP.guide on Amiga)
  106.  
  107.  
  108.                     Stephane Zermatten
  109.                     Stephane.Zermatten@earthling.net
  110.  
  111.